home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr37 / spotv200.zip / SPOTCHEK.DOC < prev    next >
Text File  |  1995-03-17  |  33KB  |  784 lines

  1.  
  2.  
  3. ┌─────┐ ┌──────┐ ┌───────┐ ┌─────┐ ┌─┐ ┌─┐ ┌──────┐ ┌──────┐ ┌─────┐ ┌──────┐
  4. │ ┌─┐ │ │ ┌──┐ │ │ ┌┐ ┌┐ │ │ ┌─┐ │ │ │ │ │ └┐ ┌─┐ │ │ ┌──┐ │ └─┐ ┌─┘ │ ┌──┐ │
  5. │ │ └─┘ │ │  │ │ │ ││ ││ │ │ └─┘ │ │ │ │ │  │ │ │ │ │ └──┘ │   │ │   │ └──┘ │
  6. │ │ ┌─┐ │ │  │ │ │ │└─┘│ │ │ ┌───┘ │ │ │ │  │ │ │ │ │ ┌──┐ │   │ │   │ ┌──┐ │
  7. │ └─┘ │ │ └──┘ │ │ │   │ │ │ │     │ └─┘ │ ┌┘ └─┘ │ │ │  │ │   │ │   │ │  │ │
  8. └─────┘ └──────┘ └─┘   └─┘ └─┘     └─────┘ └──────┘ └─┘  └─┘   └─┘   └─┘  └─┘
  9.  
  10.  
  11.          ┌─────┐ ┌─┐ ┌─┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌───────┐ ┌─────┐
  12.          │ ┌───┘ │ │ │ │ │ ┌───┘ └─┐ ┌─┘ │ ┌───┘ │ ┌┐ ┌┐ │ │ ┌───┘
  13.          │ └───┐ │ └─┘ │ │ └───┐   │ │   │ └─┐   │ ││ ││ │ │ └───┐
  14.          └───┐ │ └─┐ ┌─┘ └───┐ │   │ │   │ ┌─┘   │ │└─┘│ │ └───┐ │
  15.          ┌───┘ │   │ │   ┌───┘ │   │ │   │ └───┐ │ │   │ │ ┌───┘ │
  16.          └─────┘   └─┘   └─────┘   └─┘   └─────┘ └─┘   └─┘ └─────┘
  17.  
  18.  
  19.                    SpotChek v2.o, Written by Steve Tupy
  20.                    Copyright (C) 1995 CompuData Systems
  21.                             All Rights Reserved
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                               SpotChek v2.o
  28.  
  29.           Copyright 1995, CompuData Systems, All Rights Reserved.
  30.        ─────────────────────────────────────────────────────────────
  31.  
  32.  
  33.          
  34.      ─────────────────────────────────────────────────────────────────
  35.      WARNING WARNING  WARNING WARNING WARNING  WARNING WARNING WARNING
  36.      ─────────────────────────────────────────────────────────────────
  37.      This program is  NOT FREE.  We support the  shareware concept  in
  38.      allowing you  to try this program  out , but FULLY  expect you to
  39.      support us  in making this program everything  it can be. This is
  40.      something that CANNOT be done if you do not register the programs
  41.      you use! This is NOT an option! You are entitled to evaluate this
  42.      program for  not more than 30 days at which time you are expected
  43.      to  either  delete  it  from  your  system(s)  or  register   it.
  44.      ─────────────────────────────────────────────────────────────────
  45.  
  46.  
  47.  
  48. Introduction
  49. ────────────
  50.  
  51.   SpotChek is an Uploaded Files Processor. SpotChek will do the
  52.   following, all of which are optional and configurable by the sysop.
  53.   This version of SpotChek is designed to run with Clark Developments
  54.   PcBoard BBS system, version 15.0 or higher.
  55.  
  56. - Checks to see if this file is unwanted. A TrashCan file is checked for
  57.   filenames(wildcards accepted) and if the currently uploaded file
  58.   matches one of the filenames, appropriate action is taken depending on
  59.   how you configured SpotChek to handle it.
  60.  
  61. - Does a CRC check of the file to see if it is a duplicate file already
  62.   uploaded to the system. CRC calculation of the file ensures that the
  63.   filename can't be changed because the calculation is on the file, not
  64.   the filename.   + Reg'd mode only.
  65.  
  66. - Imports File Id type files. These are by now an accepted standard of
  67.   describing whats in archives. SpotChek has full support for extracting
  68.   these files and putting them into your  DIR files as descriptions.
  69.  
  70. - Extracts the archive to a temporary directory. This allows SpotChek to
  71.   do various processing tasks, necessary for archive conversion, virus
  72.   scanning, and file_id insertion. Fully configurable, the only side
  73.   effect to disabling this option is not having the above options.
  74.  
  75. - Performs a Virus scan with your favorite scanner. Merely enter the
  76.   command line in the config program and you may use any existing Virus
  77.   system.
  78.  
  79. - Checks to see if you want to convert all archives to a default format.
  80.   If you do, SpotChek will recreate an archive and update all the
  81.   necessary PcBoard files. After a succesful convert, SpotChek resumes
  82.   the remaining tests on the file using the new format.
  83.   +Reg'd mode only
  84.  
  85. - Performs a CRC override of the archive. This is handy if you have
  86.   disabled the above functions, but still want to test for CRC
  87.   integrity, or to recheck a converted archive.
  88.  
  89. - Will optionally insert a Comment file (except LHA, it does not support
  90.   commenting) into the archive header. Any text file containing your
  91.   comment can be used. A set of predefined macros may be used in this
  92.   text file so that you may insert system info or file info into the
  93.   comment with up to the minute information available, giving power to
  94.   fully customize your comments and/or archive headers.
  95.  
  96. - Checks for files from within the archive that are undesirable. This
  97.   may include advertisements from other BBS's or any unwanted file.
  98.   Please remember that the difference between this and the trashcan
  99.   is that the TrashCan checks the files name, this function checks the
  100.   filenames from within the archive, not the actual filename itself.
  101.  
  102. - SpotChek will optionally insert a file or advertisement of your
  103.   choice. This may again be any file you wish to insert.
  104.  
  105. - 6 Archive protocols are supported....
  106.  
  107.       1. ZIP
  108.       2. ARJ
  109.       3. ARC
  110.       4. ZOO
  111.       5. LHA (or LZH)
  112.       6. PAK
  113.  
  114. - At any time, if the file fails any of the tests, you may optionally
  115.   move the file to a bad/alternate directory. This may be a file with a
  116.   virus in it, or any other thing that may have gone wrong with it. The
  117.   alternate directory may be an offline directory that protects other
  118.   users from downloading it, at least until you get a chance to check it
  119.   or remove a virus etc...
  120.  
  121. - Also, at any time, if the file fails, SpotChek will generate a message
  122.   to either the user or the sysop or both indicating which file failed,
  123.   what time and other info you may wish to insert. You may also override
  124.   the users current conference, and force all mail generated by SpotChek
  125.   into your Main Conference, away from echomail scanners etc...
  126.   A full set of macros are supported along WITH the PCB @macros@
  127.  
  128. - Two modes of operation are used by SpotChek. UPLOAD is the initial
  129.   upload of the file and will result in all the tests being run. TEST is
  130.   a user who is online and executing the TEST command, in which case
  131.   SpotChek will abort the dupe check and the file_id insert as it is
  132.   assumed it has already been done, making the processor quicker at the
  133.   task at hand.
  134.  
  135. - Full logging is supported, including filenames and all errors SpotChek
  136.   might encounter. You may optionally have SpotChek write to its own log
  137.   file, located anywhere you wish, or simply have SpotChek write to the
  138.   current default logfile for that particular node.
  139.  
  140. - "TackFiles" may be inserted onto the end of the FILE ID files, meaning
  141.   you can append the text in this file to the end of the file id, so that
  142.   if systems who get this file after you who also insert file id files as
  143.   descriptions will then see the text you had inserted.
  144.  
  145. - Optionally, if there is no file_id.diz file found in the archive, SpotChek
  146.   will take the users description and add it to the archive as a valid file
  147.   id file. During this operation, SpotChek will insert any tackfiles
  148.   specified.
  149.  
  150.  
  151.  
  152. ─────────────────────────══════════════════════───────────────────────────────
  153.                           Configuring SpotChek
  154.                          ──────────────────────
  155.  
  156.  
  157.  
  158.  
  159.   Fire up the configuration program, SPOTCFG.EXE, and start at the top.
  160. SpotChek has a full built in help system that would almost ensure a
  161. clean configure, but we will go over all the fine points here anyways.
  162.  
  163.  
  164.  
  165.  
  166. A Note about Multi-Node Systems!!
  167. ─────────────────────────────────
  168.   Make sure you run SpotCFG from one of your PCB directories as the
  169. config file is saved in the current directory the config program is
  170. running from. This way each time SpotChek runs, it will be sure to
  171. find its configuration files. Be sure that there is a copy of the
  172. CFG file in EACH nodes working PCB directory. In a multi node system,
  173. each node MUST point to a unique working directory. If you fail to do
  174. this and have all nodes extracting to one file directory, you will
  175. surely have interesting results and files that may be "mangled" in
  176. together if file conversion is taking place. SpotChek fully supports
  177. multi node systems and will honor all file sharing within the PCB
  178. envoironment.  Because of this you may notice a small box appear
  179. near the bottom of your screen from time to time with a countown
  180. timer in it counting down from 10 to zero. This is merely SpotChek
  181. waiting for file access on your network. SpotChek will try this
  182. 10 second routine ONLY 5 times. If SpotChek FAILS to gain
  183. access to your DIR files, it will write its info into the PCB
  184. system files so that the description will be pulled into the DIR
  185. file by PCB the next time it loads up that areas DIR file, either
  186. from PCBFILER or from PcBoard itself. This gaurantees that you will
  187. not lose important info about the files that are coming into your
  188. system. This file sharing mechanism is also supported in a regular
  189. non network envioronment, but likely will not ever be tested.
  190.  
  191.  
  192. Paths/FileNames
  193. ═══════════════
  194.  
  195. - Path/FileName of "TackFile"
  196.  
  197.         A full path and filename of a textfile you can maintain and
  198. insert as an addendum to the file id file included with most archives.
  199. If there is no file id file, this will be ignored.
  200.  
  201.  
  202. - Path/FileName of your Add File
  203.  
  204.  
  205.         This is a file you wish to have added to the archive. This may
  206. be any filename, as long as it exists. If it does not exist, SpotChek
  207. will log an error telling you it cound not find the file.
  208.  
  209.  
  210. - Path to your Temporary Directory
  211.  
  212.  
  213.         Path to a work directory where SpotChek will store temporary
  214. files it creates when extracting, file_id insertion, virus scanning and
  215. archive conversion. This directory MUST be empty as SpotChek will wipe
  216. it and ALL subdirectories from it that may exist, so please make sure
  217. this path is a solo path. Here you may want to make use of a RAM drive
  218. to increase performance and reduce on drive wear and tear.
  219.  
  220.  
  221. - Path/FileName of your StripFile
  222.  
  223.  
  224.         This is a file that includes one filename per line, wildcards
  225. permitted, of all the files you want stripped out of the archive. The
  226. main difference between this and the TrashCan function is that this
  227. takes files from within the archive, not checking the filename itself.
  228.  
  229.  
  230. - Path/FileName of the TrashCan
  231.  
  232.  
  233.         This is a file that includes one filename per line, wildcards
  234. permitted, of all the files you don't want uploaded to your system. The
  235. difference between this and the above StripFile option is that this only
  236. checks the filename being uploaded (eg. *.GIF) and will only act on a
  237. violation of the filename, nothing else.
  238.  
  239.  
  240. - Path to your Bad Files Directory
  241.  
  242.  
  243.         Path to an optional directory you may wish to have files moved
  244. to when a file fails, for whatever reason. You may then have the file
  245. offline, away from prospective downloaders until you can determine if
  246. the file can be cleaned or repaired. This may include a directory with
  247. files already in them, they are not touched or deleted in any way.
  248.  
  249.  
  250. - Path/FileName of your Log File
  251.  
  252.  
  253.         This is an optional path to a file that will be maintained by
  254. SpotChek. Please note that if the "Log to PCB" prompt on the switches
  255. menu will override this. This will only be disabled if you have both the
  256. log to pcb prompt set to "N" and this line blank.
  257.  
  258.  
  259. - Path/FileName of Comment File
  260.  
  261.  
  262.         This is a text file to be used to insert as a comment into the
  263. archive. LHA or LZH does not support this. Please remember to leave the
  264. first line blank for the proper formatting of the comment file while
  265. displaying the header in the text file. If this file does not exist,
  266. SpotChek will log an error, but no other harm is done. You may optionally
  267. insert a series of macros into the text of this file to enhance your
  268. archive comments that are inserted at program runtime. These are as
  269. follows...
  270.  
  271.   %T%   Time this file was uploaded to the system. This will be in the
  272.         format of HH:MM:SS.
  273.   %F%   Full FileName and Extension.
  274.   %D%   The Date the file was uploaded in the format of MM/DD/YY.
  275.   %U%   The users name who uploaded this file, if available(MUST have
  276.         Users.Sys File via the spot.ppe included).
  277.   %B%   Board or System Name as it appears in your PCBSetup.
  278.   %O%   PCB Sysops Full Name as it appears in your PCBSetup.
  279.   %P%   SpotCheks Name and version number as well as a string telling
  280.         you if the version of SpotChek that processed this file is
  281.         registered or not. If it is, you will see a "Registered at the
  282.         end of this line, otherwise "UNREGISTERED" shows up instead.
  283.   %S%   File Size of the file uploaded, in bytes.
  284.  
  285. ... these may be inserted freely into the text, but be careful how you
  286. format the text. This will NOT work...
  287.  
  288.   ┌──────────────────┐
  289.   │ File Name  : %F% │
  290.  
  291.   as it will show up like this...
  292.  
  293.   ┌──────────────────┐
  294.   │ File Name  : FILENAME.ZIP │
  295.  
  296.   after it is expanded into the full text. You will have to play with this
  297.   get the desired results. A sample file called COMMENT.TXT is included with
  298.   the distribution archive to give you a sample of what something that
  299.   works well with this feature looks like.
  300.  
  301.  
  302. - Path/FileName of Intro Screen
  303.  
  304.  
  305.         A file used for displaying the initial screen to the user. This
  306. is a fully qualified path and name of a file that exists. If it does
  307. not, SpotChek will ignore it and not show it. There is a sample Screen
  308. called INTRO included with the distribution archive. Please note that
  309. you may at any time disable this function (to further customize your
  310. system) by simply leaving the field blank in your config program. Also
  311. note that you may use any of the PCB color codes as they are translated
  312. and shown to users at run time, and ANY PCB system macros may also be
  313. used, but not all of the same ones the BBS has. Here is a list of
  314. available macros available to SpotChek...
  315.  
  316.  
  317. @AUTOMORE@
  318. @BEEP@
  319. @BOARDNAME@
  320. @BPS@
  321. @CITY@
  322. @CLREOL@
  323. @CLS@
  324. @DATAPHONE@
  325. @DAYBYTES@
  326. @DLBYTES@
  327. @DLFILES@
  328. @EVENT@
  329. @EXPDATE@
  330. @EXPDAYS@
  331. @FIRSTU@
  332. @FIRST@
  333. @HOMEPHONE@
  334. @LASTDATEON@
  335. @MORE@
  336. @MSGLEFT@
  337. @MSGREAD@
  338. @NODE@
  339. @NUMTIMESON@
  340. @OPTEXT@
  341. @PAUSE@
  342. @POFF@
  343. @PON@
  344. @QON@
  345. @QOFF@
  346. @SECURITY@
  347. @SYSDATE@
  348. @SYSOPIN@
  349. @SYSOPOUT@
  350. @SYSTIME@
  351. @TIMELEFT@
  352. @TIMEUSED@
  353. @TOTALTIME@
  354. @UPBYTES@
  355. @UPFILES@
  356. @USER@
  357. @WAIT@
  358. @Xbf  .... where b = background color and f = foreground color
  359. @X00
  360. @XFF
  361.  
  362.  
  363.   If you need further assistance with the description of each of these
  364. macros, please consult your PcBoard Manual, but please remember, not all
  365. of the macros supported by PcBoard are supported by SpotChek. As many as
  366. possible were fit in, but limitations kept us from using all of them.
  367. All of the above macros are supported by SpotChek.
  368.  
  369.  
  370. - Path/FileName of Main Screen
  371.  
  372.  
  373.         The Main Screen for SpotChek. This Screen should only ever be
  374. designed for use with the first 19 lines. In other words, SpotChek
  375. reserves the last 5 lines for the User box ( a small text box which
  376. keeps the user updated on what is happening during the processing ). So
  377. , if you created a screen which only used up the first 19 lines of the
  378. screen, you would not have the over bleeding, or scrolling of the users
  379. screen. There is a sample screen included called MAIN in the
  380. distribution archive. You may leave this blank to disable the function,
  381. but it is strongly suggested to show at least something as all SpotChek
  382. puts to the screen is the "Windows" looking box at the bottom of the
  383. screen. It will be changed soon to have configurable color selection.
  384.  
  385.  
  386. - Path/FileName of the Failed Screen
  387.  
  388.  
  389.         This is the screen shown to users upon a file failing any of the
  390. tests configured. As before, you may use any of the macros within this
  391. file, SpotChek will recognize them. There is a sample screen included
  392. with the archive called FAILED which you are free to use. You may also
  393. create your own.
  394.  
  395.  
  396. - Path/FileName of the Bye Screen
  397.  
  398.  
  399.         This is a file holding a screen shown to users (optionally) upon
  400. leaving SpotChek. This may be disabled by simply leaving the field
  401. blank. All of the above macros are supported. There is a sample screen
  402. included with this archive called BYE. All screens are in ansi, but can
  403. be converted to PCB color codes if you wish, or you may draw your own to
  404. give your file processor its own flavor.
  405.  
  406.  
  407. - To Sysop, Path / MsgFile
  408.  
  409.  
  410.   This is a path and name of a file that holds the text you wish to use
  411. as the message text of the message you wish to post to the Sysop upon a
  412. file failing SpotCheks testing. This may include any of PCB's color
  413. codes or macros, including any of the ones not included above. Also
  414. supported in this text file are a few extra macros explained here...
  415.  
  416.   %T%   Time this file was uploaded to the system. This will be in the
  417.         format of HH:MM:SS.
  418.   %F%   Full FileName and Extension.
  419.   %D%   The Date the file was uploaded in the format of MM/DD/YY.
  420.   %U%   The users name who uploaded this file, if available(MUST have
  421.         Users.Sys File via the spot.ppe included).
  422.   %B%   Board or System Name as it appears in your PCBSetup.
  423.   %O%   PCB Sysops Full Name as it appears in your PCBSetup.
  424.   %P%   SpotCheks Name and version number as well as a string telling
  425.         you if the version of SpotChek that processed this file is
  426.         registered or not. If it is, you will see a "Registered at the
  427.         end of this line, otherwise "UNREGISTERED" shows up instead.
  428.   %S%   File Size of the file uploaded, in bytes.
  429.   %E%   The Error Condition that caused this file to fail. It will be
  430.         in the form "Archive Conversion" , "Duplicate File" ,
  431.         "CRC Table Bad" or "Trashcan Fail".
  432.  
  433. ... these may be inserted freely into the text, but be careful how you
  434. format the text. This will NOT work...
  435.  
  436.   ┌──────────────────┐
  437.   │ File Name  : %F% │
  438.  
  439.   as it will show up like this...
  440.  
  441.   ┌──────────────────┐
  442.   │ File Name  : FILENAME.ZIP │
  443.  
  444.   after it is expanded into the full text. You will have to play with this
  445.   get the desired results. Sample files called BADFILE.* are included with
  446.   the distribution archive to give you a sample of what something that
  447.   works well with this feature looks like.
  448.  
  449.  
  450. - To Users, Path / MsgFile
  451.  
  452.  
  453.   Same as above, this is a path and filename of a text file containing
  454. the message text of the message you wish SpotChek to post to the user
  455. upon a failed upload of theirs. As above, you may use PCB's color codes.
  456. Please see above for explanation of extended macro commands.
  457.  
  458.  
  459. - To Sysop, Path / Message Base
  460.  
  461.  
  462.   This is the actual message base name of the base you want to write the
  463. message to. If you can't remember the name and you have PCB set up in your
  464. envoironment, pressing F2 will pull up all your conference info, so that
  465. all you have to do is select the base you want the message to go to.
  466.  
  467.  
  468. - To Users, Path / Message Base
  469.  
  470.  
  471.   As above, but this field applies to the user and not the sysop.
  472.  
  473.  
  474.  
  475. Archivers / Utilities
  476. ═════════════════════
  477.  
  478.  
  479. - Archive / Unarchiver Command Lines
  480.  
  481.   These are all set up for you, but if you should happen to not use the
  482. default settings for the default archivers, you may use any one you wish.
  483. Please remember to keep the .EXE off of the end of the name. It won't
  484. harm SpotChek, but it does make things run a lot smoother. Default
  485. command line parameters are provided and are adequate for most of the
  486. "generic" archiver programs. Please make note that SpotChek supports use
  487. of sub directories, so make sure the archiver is set to extract to sub
  488. directories as well.
  489.  
  490. - Virus Scanner / Command Line
  491.  
  492. Memory can be a consideration here, so if your particular Virus Scanner
  493. has any memory requirements beyond an average of 350K (this is only an
  494. average, all systems have different configurations and may vary
  495. slightly), you may wish to set it up to use extended memory. This is not
  496. a fault of SpotCheks as it only maintains a minumum of memory, but it is
  497. shelled under PCB and may not have as much memory to work with as might
  498. be necessary to invoke your particular Virus Scanner.
  499.  
  500. - Force Failed Messages to Main?
  501.  
  502.   This is to force SpotChek to place any messages it generates into the
  503. main conference by default. This forces SpotChek to find the appropriate
  504. base to add the message to. If this is not set, SpotChek will place the
  505. message in the users current conference. This may not be desirable as
  506. you may have echo bases where you do not want internal system generated
  507. messages getting scanned and sent out to other nodes. This toggle is
  508. usually set to "Y"
  509.  
  510.  
  511. Switches  (or Toggles)
  512. ════════
  513.  
  514. - Post Message to User on Failed Upload?
  515.  
  516.   This instructs SpotChek to post a message to the User, but only if the file
  517. fails the upload tests you have specified. You have three options here.
  518. You may have SpotChek not post a message at all, post a message in the
  519. users current conference, or have SpotChek override and automatically
  520. post the message to the main conference. This is preferrable in a
  521. situation where you may have many echomail conferences and messages of
  522. this type are not desirable in echomail conferences. The Main Board is
  523. usually set to handle private messages. SpotChek will set the private
  524. bit by default when generating its messages.
  525.  
  526. - Post Message to Sysop on Failed Upload?
  527.  
  528.   The same rule applies here as above, except that the target for this
  529. message is for the Sysop. The "To" field will have your name entered as
  530. it is entered in your PCBSETUP, so all your regular mail scans should
  531. work properly, notifying you of the new mail waiting. The same three
  532. options apply here as above.
  533.  
  534. - Move Files to Bad Dir on Failed Upload?
  535.  
  536.   SpotChek can move failed files to an offline directory or an alternate
  537. directory so that you may investigate it later. This serves to also
  538. protect your users from potentially bad or infected files. The file is
  539. moved, not copied, so the original file is deleted.
  540.  
  541. - Insert File Id as Description?
  542.  
  543.   Sometimes a file called FILE_ID.DIZ is included with the archive that
  544. is uploaded. This is quickly becoming a standard as the file id contains
  545. info about the file that may be important to show to the users. SpotChek
  546. supports full file_id insertion and will automatically insert the file
  547. id in place of what the user entered as a description. If you answer "N"
  548. to this and there is indeed a file id file in the archive, you may notice
  549. a message from the PCB system saying "Contains FILE_ID.DIZ File" in place
  550. of where a description should be in your upload DIR file.
  551.  
  552. - Check for Duplicates?
  553.  
  554.   SpotChek has an internal duplicate checking system which handles an
  555. unlimited number of files  for duplicates,  using a CRC calculation of
  556. the file contents. This ensures that the filename hasn't been changed to
  557. fool you into thinking it is a different file. A small database is
  558. maintained in your home SpotChek directory which is necessary for
  559. SpotChek to record the file info. This file will grow as more files get
  560. uploaded. For each file, SpotChek reserves 4 bytes of disk space, so if
  561. you used a total 9999 files, you would have a 40K datafile , which is
  562. easy to maintain. It is done automatically by SpotChek. Please remember
  563. that the more filenames you are maintaining in the dupe database, the
  564. longer SpotChek may take to find them, so keeping this number at a
  565. compromise between speed and number of files handled for more power
  566. helps in the overall performance of the program.
  567.  
  568. - How Many Files to Maintain in Duplicate List
  569.  
  570.   If the above switch is set to "Y", then this number tells SpotChek
  571. exactly how many files to maintain in its list. Please note the size of
  572. the file you will have to have in order for this to function.
  573.  
  574. - CRC Check OverRide?
  575.  
  576.   If for some reason you wish to not use the extract, scan, convert and
  577. file id functions, you may still wish to simply use the CRC test on the
  578. archive as an override. Assuming you are using the extract, scan etc,
  579. functions, a successful extract already means the archive has a valid
  580. CRC, so this function becomes redundant. In that case, you can shut this
  581. feature off.
  582.  
  583. - Convert Files to Default Format?
  584.  
  585.   If you have configured SpotChek to extract, scan, and insert, you may
  586. also convert all your files to a default format. For example, you wish
  587. all the files to be ZIP's, and you recieve a *.ARJ file, SpotChek will
  588. convert the file over and update all the PCB files and stats. The amount
  589. of bytes uploaded are not changed, however, as the original number of
  590. bytes transferred remain the updated amount the user recieves credit
  591. for.
  592.  
  593. - Default Convert Format
  594.  
  595.   This is the 3 character format specifier. Available formats are...
  596.  
  597. ZIP, ARJ, LHA (or LHZ), ARC, ZOO, PAK.
  598.  
  599.   Entering any of these codes will tell SpotChek which format you wish
  600. to use.
  601.  
  602. - OverRide and Write to PCB log File?
  603.  
  604.   This tells SpotChek to put all log entries into your log file
  605. specified in your PCBSETUP. SpotChek will append this file with a
  606. similar format to PcBoard's. If this is set to "N" and the logfile path
  607. is a valid filename, SpotChek will append that file instead of the PCB
  608. one.
  609.  
  610. - Check File Dates to See if They are Too Old?
  611.  
  612.   SpotChek will check the files in the archive for dates that are older than
  613. the specified date in the field below. This is just the toggle that will
  614. tell SpotChek whether or not to carry out the function.
  615.  
  616. - If Above = Y, Then What Date is the Cutoff Date for Failed Files?
  617.  
  618.   This is the date that will be the cutoff point for the files in the
  619. archive. If any file in the archive is older than this date, the file
  620. will be considered a failed file and SpotChek will act accordingly.
  621.  
  622. - Create File Id File with Description if No File Id exists in Archive?
  623.  
  624.   This instructs SpotChek to look into the archive and if no file id file
  625. exists, SpotChek will pull the description the user entered(if available)
  626. and add it to the archive as a valid file id file. This ensures that
  627. ALL files coming into your system go out with file id files in them. This
  628. supports the True two way file id concept becoming increasingly popular
  629. on todays Bulletin Board Systems.
  630.  
  631.  
  632. Colors
  633. ══════
  634.  
  635. - Box Color
  636.  
  637.   This is the color used for the actual box, not the text. The color selection
  638.  box is easy to use, just point and hit enter. At any time while leafing
  639.  through the selections, you may hit either F10 also to achieve the same thing.
  640.  
  641. - Raise Color
  642.  
  643.   The box can be made to appear 3 D when using this wisely. This will alter
  644. only the left and top sides of the box, giving you shading and giving the
  645. impression of a 3 Dimensional box, as is the case with such programs as
  646. Windows.
  647.  
  648. - Filename Color
  649.  
  650.   The color for the actual filename in the box.
  651.  
  652. - Action Color
  653.  
  654.   During program execution, there will be many messages sent to the box. This
  655. is the color of regular text used for actions during this time and does NOT
  656. reflect the color of the text when the current function fails.
  657.  
  658. - Failed Box Color
  659.  
  660.   There is also a little flashing box during execution. This can be altered
  661. during an error, as is the case with this selection. A bright color such as
  662. red works good here as the user sees it easier.
  663.  
  664. - Ok Box Color
  665.  
  666.   As with above, when the current function is succesful, this color will
  667. determine how the box will look.
  668.  
  669. ─────────────────────────═══════════════════════───────────────────────────────
  670.                            Installing SpotChek
  671.                          ───────────────────────
  672.  
  673.  
  674. Following is a brief explanation of how to install SpotChek copying all the
  675. files manually and/or if you are installing an upgrade...
  676.  
  677. 1 - Extract all the files in this archive into a directory specified in
  678.     your path. Make sure all executables, and all *.hlp and *.idx files
  679.     are in this directory also. You MUST run the config program from
  680.     the directory you wish to run PCB from as this is the directory the
  681.     config file will be saved to!
  682.  
  683. 2 - Run SpotCFG and put in all paths and switches etc.
  684.  
  685. 3 - Install the Spot.Ppe file included with this archive into your
  686.     PCBTEXT file. MKPCBTXT <PCBTEXT> will work on this in your GEN
  687.     directory. Line 433 must be altered to reflect a line that looks
  688.     something like this....
  689.  
  690. !c:\pcb\ppe\spot.ppe
  691.  
  692.     This will tell PCB to run the SPOT.PPE. That PPE is only a small PPE
  693.     that creates a USERS.SYS file as PcBoard does not include such an
  694.     option. This is important to the function of SpotChek as it is
  695.     needed for conference paths, directory paths , users name etc...
  696.     Without this file, SpotChek will not know who is online at any given
  697.     time and will bark up with a "Leave Comment to Sysop there is a
  698.     problem with USER.SYS" message. This is not desctructive and is the
  699.     default mode while a user is online, but SpotChek will refuse to
  700.     post a message or refuse to run altogether if it cannot find the
  701.     drop file.
  702.  
  703. 4 - Edit a file in your PCB directory called PCBTEST.BAT. This batch
  704.     file should include only the line...
  705.  
  706. SpotChek %1 %2 %3
  707.  
  708.     This is necessary for SpotChek as PcBoard passes certain parameters
  709.     on the command line, which get translated by the %1 %2 etc.
  710.  
  711.           That is it, SpotChek should be fully functional, provided you
  712.     set up everything properly. You can netmail CompuData Systems to
  713.     gain access to support for SpotChek. (see below)
  714.  
  715.     Following are a couple of reasons why SpotChek may NOT be running
  716.     after you have completed your install....
  717.  
  718. 1 - SpotChek Fails every file coming into the system for no apparent
  719.     reason...
  720.  
  721.     If any of the utilities run out of memory or if there is a problem
  722.     with any of the utilities paths or config's , SpotChek will report
  723.     an error and fail the file automatically as it will assume the
  724.     archiver or utility came back with an error. This is often the case
  725.     when you have a lot of TSR's loaded and have less than 512K free
  726.     after loading up your system. One example of this is McAffees Scan
  727.     program. It uses up alot of memory, 400+ K of memory at times, so
  728.     in reporting back an error of 2, out of memory, the file did not
  729.     fail so much as SpotChek THINKS it failed. By trimming down on
  730.     system overhead such problems as this may be averted. SpotChek,
  731.     since there are so many utilities out there, will report and abort
  732.     on any non zero program return. Try to omit the scanner by leaving
  733.     that line blank in the config and if you are no longer having the
  734.     problem, try to reduce the amount of memory you are using during
  735.     computer startup, as the virus scanner ran out of memory.
  736.  
  737. 2 - The Status Bar at the bottom of the screen does not show up and
  738.     the default main screens stats show no values.
  739.  
  740.     There was no USER.SYS file present and SpotChek did not know who is
  741.     online, so it aborted refreshing the statusbar(which only holds user
  742.     info anyways) and did not report the users stats on the user screen.
  743.     Check your PCBTEXT file for the above PPE installation.
  744.  
  745. 3 - SpotChek extracts the file AND still does a CRC test of the file.
  746.     This is not acceptable because if the file passed the extract, it is
  747.     obviously a good file, at least from the perspective of having a good
  748.     CRC value and being readable, so doing a CRC test is not necessary.
  749.     In the config program under Toggles, you may disable the override.
  750.     Please note that CRC does not relate to the CRC encryption that is
  751.     done during the duplicate file check, which uses a CRC32 value of
  752.     the file itself, not just the name, for its CRC value. That way if
  753.     even one character in that file is different it is not considered a
  754.     duplicate.
  755.  
  756. ───────────────────────────────────────────────────────────────────────────────
  757.  
  758. - SpotChek and CompuData Systems will be supporting this product quite
  759.   extensively, so getting future support should not be a consideration
  760.   in purchasing SpotChek, but an explanation is in order.
  761.  
  762. ───────────────────────────────────────────────────────────────────────────────
  763.  
  764.                       IMPORTANT NOTICE ABOUT SPOTCHEK
  765.  
  766.   As of this version 2.o of SpotChek, CompuData has chosen to support and
  767.   develop SpotChek by themselves rather than license it out to Dynagrafix
  768.   Developments, although the support board, for conveniance, will REMAIN
  769.   at Dynagrafix Developments at 1:229/412. All Orders can be made on that
  770.   system as well, including the credit card orders. Also please note that
  771.   the original author, Steve Tupy, who owns and runs CompuData Systems,
  772.   is and will be the sole supporter/developer of this product.
  773.  
  774. ───────────────────────────────────────────────────────────────────────────────
  775.                                   Support
  776.                                ─────═══─────
  777.  
  778.   Support is available from the Dynagrafix Developments System, but will
  779.   be handled by CompuData System Staff. You can netmail 1:229/412, or
  780.   tie into an echo called COMPUDATA, which may or may not be available
  781.   to you. If you wish to find out more, please netmail us, we will get
  782.   back to you quite quickly.
  783.  
  784.